Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 2 - 3D Viewer / 3D Viewer Reference

Constants

Viewer Flags

When you create a new viewer object (by calling Q3ViewerNew), you need to specify a set of viewer flags that control various aspects of the new viewer object.

enum {
   kQ3ViewerShowBadge         = 1<<0,
   kQ3ViewerActive            = 1<<1,
   kQ3ViewerControllerVisible = 1<<2,
   kQ3ViewerDrawFrame         = 1<<3,
   kQ3ViewerDraggingOff       = 1<<4,
   kQ3ViewerButtonCamera      = 1<<5,
   kQ3ViewerButtonTruck       = 1<<6,
   kQ3ViewerButtonOrbit       = 1<<7,
   kQ3ViewerButtonZoom        = 1<<8,
   kQ3ViewerButtonDolly       = 1<<9,
   kQ3ViewerDefault           = (kQ3ViewerViewerActive | 
                                 kQ3ViewerControllerVisible | 
                                 kQ3ViewerButtonCamera | 
                                 kQ3ViewerButtonTruck | 
                                 kQ3ViewerButtonOrbit)
};

Constant descriptions

kQ3ViewerShowBadge

If this flag is set, a badge is displayed in the viewer pane whenever the controller strip is not visible. See "Badges" on page 2-6 for complete details on when the badge appears and disappears. If this flag is clear, no badge is displayed.

kQ3ViewerActive

If this flag is set, the viewer object is active.

kQ3ViewerControllerVisible

If this flag is set, the controller strip is visible. If this flag is clear, the controller strip is not visible. If the kQ3ViewerShowBadge flag is set, the controller strip is visible whenever the badge is not displayed.

kQ3ViewerDrawFrame

If this flag is set, a frame is drawn around the viewer pane. If this flag is clear, no frame is drawn around the viewer pane.

kQ3ViewerDraggingOff

If this flag is set, dragging is turned off in the viewer pane.

kQ3ViewerButtonCamera

If this flag is set, the camera angle button in the controller strip is displayed and is active.

kQ3ViewerButtonTruck

If this flag is set, the distance button in the controller strip is displayed and is active.

kQ3ViewerButtonOrbit

If this flag is set, the rotate button in the controller strip is displayed and is active.

kQ3ViewerButtonZoom

If this flag is set, the zoom button in the controller strip is displayed and is active.

kQ3ViewerButtonDolly

If this flag is set, the move button in the controller strip is displayed and is active.

kQ3ViewerDefault

The default configuration for a viewer object.